home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / src / Games / xmris / xmris.doc < prev    next >
Encoding:
Text File  |  1995-05-03  |  6.6 KB  |  199 lines
  1.  
  2.  
  3.  
  4. XMRIS(6)                                                 XMRIS(6)
  5.  
  6.  
  7. NNAAMMEE
  8.        xmris - video arcade game for _X
  9.  
  10. SSYYNNOOPPSSIISS
  11.        xxmmrriiss [-option ...]
  12.  
  13.        xxmmssiitt [-option ...]
  14.  
  15. DDEESSCCRRIIPPTTIIOONN
  16.        _x_m_r_i_s  is a version of the Mr Do video arcade game for the
  17.        X Window System.
  18.  
  19.        You control a gnome, who can walk around a  garden,  along
  20.        paths  already  marked,  or  create new paths wherever you
  21.        wish. You also have a ball, which can  be  thrown  in  the
  22.        direction  you're facing, towards the gnome's feet. Points
  23.        are scored for collecting cherries (if you collect 8 cher-
  24.        ries  without stopping, you get a bonus), killing monsters
  25.        (by squashing them, or throwing the  ball  at  them),  and
  26.        collecting  the prize left when all the monsters have come
  27.        out of their den.
  28.  
  29.        Extra lives are obtained by filling in  the  'EXTRA'  mon-
  30.        sters  at  the  top  of the screen. One of these comes out
  31.        every 5000 points, and also when you get the prize,  along
  32.        with 3 drones. Killing the EXTRA will kill the drones too.
  33.        When you collect the prize, the  normal  monsters  freeze,
  34.        until  the  three drones are dead. Beware things go faster
  35.        after that!  When all the normal monsters  are  killed  or
  36.        all  the  cherries  collected,  or  you have got the final
  37.        EXTRA monster, you advance to the next screen.
  38.  
  39.        You can kill the monsters by throwing the ball at them, or
  40.        dropping  the  apples  on  them.  You  get more points for
  41.        squashing them. The EXTRA monsters and its drones, can eat
  42.        the  apples  if they're walking towards it when they meet.
  43.        You die by colliding with a monster (unless its eating  an
  44.        apple,  in  which case no harm done), or by being squashed
  45.        be a falling apple.
  46.  
  47.        The game works best with all other  processes  asleep.  If
  48.        another process gets too much processor the animation will
  49.        be jerky, and the load line along the bottom will start to
  50.        grow.  Because  an  interrupt is used to control the frame
  51.        rate, the animation is smoother than with xchomp.
  52.  
  53.        You probably want to position the pointer at the bottom of
  54.        the  window,  so that it doesn't interfere with the board.
  55.        You'll notice it flicker if one of the sprites moves under
  56.        it.
  57.  
  58. GGAAMMEE CCOONNTTRROOLLSS
  59.        The gnome can be controlled by the mouse or keyboard, this
  60.        is selected when you start a new  game.  The  gnome  walks
  61.  
  62.  
  63.  
  64. X Version 11               15 July 1992                         1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. XMRIS(6)                                                 XMRIS(6)
  71.  
  72.  
  73.        towards  the  mouse,  and throws the ball when you press a
  74.        button. You can move the mouse  at  right  angles  to  the
  75.        gnome's  direction  while its walking, the gnome continues
  76.        towards the previous destination, before  turning  towards
  77.        the  new  one. Mouse control is not that accurate for fine
  78.        control of the gnome (I don't use it). Keyboard control is
  79.        by  'z' and 'x' for left and right, and ''' and '/' for up
  80.        and down. The ball is thrown with the space bar.  Pressing
  81.        more  than  one  key, will turn the gnome appropriately at
  82.        the next intersection, so you  can  go  round  corners  by
  83.        pressing  the  new  direction key before releasing the old
  84.        one. If you try to go in a  direction  not  possible,  the
  85.        gnome will move towards the nearest intersection or in the
  86.        direction it was going, depending on how near to an inter-
  87.        section it was.
  88.  
  89.        The  game  can  be paused by iconifying it (when your boss
  90.        walks in), or by pressing 'p'. When de-iconified, the game
  91.        remains  paused. To continue press space. When paused, you
  92.        can abort the game by pressing entirely.
  93.  
  94. OOPPTTIIOONNSS
  95.        --hheellpp
  96.            Lists the command options and  some  other  info,  and
  97.            does not start the game.
  98.  
  99.        --ddiissppllaayy _d_i_s_p_l_a_y
  100.            Specifies which X server to connect to.
  101.  
  102.        --ffoonntt _f_o_n_t
  103.            Specifies which font to use.
  104.  
  105.        --rrvv Swap black and white colours.
  106.  
  107.        --bbww Use black and white, even on colour displays.
  108.  
  109.        --iiccoonniicc
  110.            Start up iconized.
  111.  
  112.        --mmrriiss
  113.  
  114.        --mmssiitt
  115.            So not to be accused of gender bias, xmris can also be
  116.            run as xmsit.  The gender of the game  is  taken  from
  117.            the program name (mris or msit) but may be over ridden
  118.            by these two switches. The game  is  known  as  Mr  Is
  119.            because the arcade game was masculine.
  120.  
  121.        The argument list is also fed to XSetStandardProperties, I
  122.        don't know what this does.
  123.  
  124. SSEEEE AALLSSOO
  125.        xchomp(6)
  126.  
  127.  
  128.  
  129.  
  130. X Version 11               15 July 1992                         2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. XMRIS(6)                                                 XMRIS(6)
  137.  
  138.  
  139. BBUUGGSS
  140.        The game is always in black and white, I haven't got round
  141.        to doing colour sprites yet, so the -bw argument is super-
  142.        fluous.
  143.  
  144.        The -iconic argument has no effect. (I don't know  how  to
  145.        get it to work.)
  146.  
  147.        Fatal  XIO  errors are not handled gracefully. Quiting the
  148.        game by using your window manager  results  in  big  error
  149.        message. I don't know how to trap this.
  150.  
  151.        The program was written with a folding editor, it might be
  152.        hard to find your way around without one.
  153.  
  154.        In order to get it to compile correctly with  both  K&R  C
  155.        and ANSI C, I've used several macros to deal with the dif-
  156.        ferences in function prototyping and argument lists. These
  157.        produce  either  proper  K&R  declarations  or proper ANSI
  158.        ones. I did have mixed declarations, with the correct pro-
  159.        motions  taken care of, but that doesn't work well for the
  160.        one varargs function. It might make  it  hard  for  things
  161.        like  ctags to work. Maybe I'll revert to the mixed decla-
  162.        rations or maybe I won't support K&R.
  163.  
  164. CCOOMMMMEENNTTSS
  165.        I welcome any comments, suggestions, code, bug reports and
  166.        fixes,  etc.   Don't  forget  to  include which version of
  167.        _x_m_r_i_s you are using (with xmris  -help),  machine,  OS,  X
  168.        release & patch number, window manager etc.
  169.  
  170. CCOOPPYYRRIIGGHHTT
  171.        Copyright (C) 1992 Nathan Sidwell.
  172.  
  173. AAUUTTHHOORR
  174.        Nathan Sidwell (nathan@inmos.co.uk)
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196. X Version 11               15 July 1992                         3
  197.  
  198.  
  199.